Field Options

The <Field> element has two sub-elements that use an <Options> tag. Both <Query> and <Calculate> can use <Options> to populate fixed values in a Combo box. Multiple radio buttons can also be defined using <Options>.

Usually Field Options are configured on screens and in transactions within the <Field> configuration. There are two parts required for configuring <Options>. First, an <OptionValue> must be defined. This is the value that is stored in the database in the TextValue column. Then, an <OptionText> must be defined. This is the text a user will see displayed in the Combo box or radio button in OIPA. Option Text is stored in the OptionText column.

Combo Display in Application

Combo Box Displaying Options

Field Option XML Example

Field Option XML Example

Configuration Consideration

Saving the option text in the database saves processing time because it allows the screen to display the option text from the database without having to execute the configuration. While it saves processing time, it also makes it impossible for a rule to fully update the value of a field on a screen that used option text.

This occurs because a rule (CopyTo, for example) can only update one value in the database. If it updates the option text, then the user will see a correctly updated field in OIPA, but the actual value will be unchanged. If it updates the option value, then the correct value will be stored in the database, but the option text the user sees will remain unchanged, giving the impression that the value is also unchanged.

Important   Do not use field options if a rule needs to update a screen field value.

It is also important to keep in mind any impact OnChange events could have on configuration if a combo box is used. OnChange events can cause combo boxes to be reloaded.